You can use SNMP to monitor the status of Director Fabric components using OIDs. Director Fabric supports both SNMPv2 and SNMPv3 protocol.
To monitor Director Fabric components, open UDP port 161 and connect to SNMP. For details on how to open a port in the Director setup, go here .
Warning
Both SNMPv2 and SNMPv3 are enabled by default to localhost. Before exposing the SNMP to UDP port 161, change the default credentials to ensure system security.
Syntax for snmpwalk via SNMPv2:
snmpwalk -v2c -c <community-string> <Server-IP>:161 .OID
Syntax for enabling SNMPv2
legacy-snmp enable
Syntax for disabling SNMPv2
legacy-snmp disable
Syntax for snmpwalk via SNMPv3:
snmpwalk -v3 -u <user name> -l authPriv -a MD5 -A <user password> -x DES -X <DES key> <Server-IP>:161 .OID
Changing Key
change-snmpv3-key
The key must be at least eight characters long. Only uppercases, lowercases, numbers, and symbols except space are accepted.
Changing Password
change-snmpv3-passwd
The password must be at least eight characters long. Only uppercases, lowercases, and numbers are accepted.
The default values of the parameters used in SNMP monitoring are as follows:
Parameter |
Default Value |
|---|---|
<community-string> |
public |
<user name> |
director |
<user password> |
changeme |
DES key |
5nMpvEenC^pt |
Fabric Server uses the base OID 1.3.6.1.4.1.54322.5 to get a list of the exposed OIDs and their details. You can also use the OID of the individual components and services in the Fabric Server to get their status.
OID |
Description |
Example Output |
|---|---|---|
1.3.6.1.4.1.54322.5.1 |
Version information of Fabric Server. |
STRING: “2.3.0” |
1.3.6.1.4.1.54322.5.2 |
Average time (in milliseconds) for I/O requests. |
STRING: “1.31” |
1.3.6.1.4.1.54322.5.3 |
VM Swapiness which represents the percentage of free memory before activating swap. The default value is 60. |
STRING: “60” |
1.3.6.1.4.1.54322.5.4 |
Size of the cluster: 1/3/5. |
INTEGER: 1 |
1.3.6.1.4.1.54322.5.5 |
Fabric Proxy |
|
1.3.6.1.4.1.54322.5.5.1 |
CPU usage in percentage. |
STRING: “0.0” |
1.3.6.1.4.1.54322.5.5.2 |
Memory usage in percentage. |
STRING: “10.65” |
1.3.6.1.4.1.54322.5.5.3 |
Count of currently active and alive client connections. |
STRING: “15” |
1.3.6.1.4.1.54322.5.5.4 |
Server state of the fabric proxy: leader/follower/standalone. |
STRING: “follower” |
1.3.6.1.4.1.54322.5.5.5 |
Number of nodes managed by the server. |
STRING: “221” |
1.3.6.1.4.1.54322.5.5.6 |
Running status of fabric proxy: active/inactive. |
STRING: “active” |
1.3.6.1.4.1.54322.5.6 |
Fabric Storage |
|
1.3.6.1.4.1.54322.5.6.1 |
CPU usage in percentage. |
STRING: “0.0” |
1.3.6.1.4.1.54322.5.6.2 |
Memory usage in percentage. |
STRING: “16.3” |
1.3.6.1.4.1.54322.5.6.3 |
Total configured capacity of fabric storage in GB. |
STRING: “74.82 GB” |
1.3.6.1.4.1.54322.5.6.4 |
Available capacity of the fabric storage in GB. |
STRING: “74.09 GB” |
1.3.6.1.4.1.54322.5.6.5 |
Percentage of DFS storage used. |
STRING: “6.75” |
1.3.6.1.4.1.54322.5.6.6 |
Number of data blocks that do not have required number of replicas for fault tolerance. |
STRING: “0” |
1.3.6.1.4.1.54322.5.6.7 |
Number of data nodes that are currently operational and actively connected to the fabric storage. |
STRING: “3” |
1.3.6.1.4.1.54322.5.7 |
Fabric Authenticator |
|
1.3.6.1.4.1.54322.5.7.1 |
CPU usage in percentage. |
STRING: “0.0” |
1.3.6.1.4.1.54322.5.7.2 |
Memory usage in percentage. |
STRING: “0.0” |
1.3.6.1.4.1.54322.5.7.3 |
Status of Fabric Authenticator Service: active/inactive. |
STRING: “active” |
1.3.6.1.4.1.54322.5.7.4 |
Status of Fabric Authenticator Admin Service: active/inactive. |
STRING: “active” |
1.3.6.1.4.1.54322.5.8 |
ZFS Pool Statistics |
|
1.3.6.1.4.1.54322.5.8.1.x |
Name of the ZFS pool. |
STRING: “data_pool” |
1.3.6.1.4.1.54322.5.8.2.x |
Health status of the pool: DEGRADED/OFFLINE/FAULTED/UNAVAIL/REMOVED/INUSE. |
STRING: “ONLINE” |
1.3.6.1.4.1.54322.5.8.3.x |
Allocated capacity of the pool. |
STRING: “29.4G” |
1.3.6.1.4.1.54322.5.8.4.x |
Free disk capacity of the pool. |
STRING: “1.87G” |
1.3.6.1.4.1.54322.5.8.5.x |
Number of read operations. |
STRING: “0” |
1.3.6.1.4.1.54322.5.8.6.x |
Number of write operations. |
STRING: “4” |
1.3.6.1.4.1.54322.5.8.7.x |
Data transfer bandwidth for the read operation in kilobytes/second. |
STRING: “3.49K” |
1.3.6.1.4.1.54322.5.8.8.x |
Data transfer bandwidth for the write operation kilobytes/second. |
STRING: “55.4K” |
To retrieve the information for a single ZFS pool, add the corresponding value of the respective pool after the ZFS pool base OID.
List of ZFS Pools
OID
Description
1
app_pool
2
data_pool
3
rpool
For example, you can use 1.3.6.1.4.1.54322.5.8 to retrieve the names of all the ZFS pools and 1.3.6.1.4.1.54322.5.8.1.1 to retrieve the name of the ZFS app pool.
API Server uses the base OID 1.3.6.1.4.1.54322.3 to get a list of the exposed OIDs and their corresponding information. You can also use the OID of the individual components and services in the API Server to get their status.
OID |
Description |
Example Output |
|---|---|---|
1.3.6.1.4.1.54322.3.1 |
Version information of API Server. |
STRING: “2.3.0” |
1.3.6.1.4.1.54322.3.2 |
Average time (in milliseconds) for I/O requests. |
STRING: “0.88” |
1.3.6.1.4.1.54322.3.3 |
VM Swapiness which represents the percentage of free memory before activating swap. The default value is 60. |
STRING: “60” |
1.3.6.1.4.1.54322.3.4 |
API Server Information |
|
1.3.6.1.4.1.54322.3.4.1 |
CPU usage in percentage. |
STRING: “0.13” |
1.3.6.1.4.1.54322.3.4.2 |
Memory usage in percentage. |
STRING: “5.02” |